home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: New Zealand Amiga Users Group / New Zealand Amiga Users Group Newsdisk v27 (1989-12)(NZAmigaUG).zip / New Zealand Amiga Users Group Newsdisk v27 (1989-12)(NZAmigaUG).adf / First ! / play.doc < prev    next >
Text File  |  1993-12-03  |  11KB  |  291 lines
  1.                        PLAY Documentation
  2.                        ==================
  3.  
  4. Sonix Score Player 1.0 - December 1, 1987
  5. (C) Copyright 1987 Mark Riley,
  6. All Rights Reserved.
  7.  
  8. Sonix is a trademark of Aegis Development, Inc.
  9. Amiga and Workbench are trademarks of Commodore-Amiga, Inc.
  10.  
  11.  
  12. Some Information About PLAY
  13. ===========================
  14.  
  15. PLAY is that program you've been patiently waiting for that'll
  16. let you listen to Sonix tunes without Sonix itself.  Not only can
  17. you play scores, but you can also create PLAY scripts that play
  18. multiple scores, one right after the next.  This allows for
  19. continuous music which is desirable for slide shows and the like.
  20. This is possible since PLAY can start a score playing, while
  21. preloading the next score.  In addition, PLAY may be used from
  22. either the Workbench or the CLI.
  23.  
  24. This program is ShareWare; it isn't free.  If you like PLAY and
  25. want to continue to use it, please send $10 to the address below.
  26. This will make you a legal user of PLAY.
  27.  
  28.   Mark Riley - Play
  29.   P.O. Box 234
  30.   Simi Valley, CA 93062
  31.  
  32. Thank you!  Paying for PLAY will help to reimburse me for the
  33. time I spent on it, as well as to provide improved versions with
  34. time...  If you have any questions or comments regarding PLAY, I
  35. can be reached at the above address or the following services:
  36.  
  37. BIX: mriley - PLINK: SONIX
  38.  
  39. PLAY is a quality program, well worth the money you'll spend for
  40. it.  With PLAY you don't need to buy an expensive music composing
  41. program if all you want to do is listen.  So, let PLAY and your
  42. Amiga rock you...
  43.  
  44. Enjoy!  -Mark-
  45.  
  46.  
  47. Important Note
  48. ==============
  49.  
  50. You (as an individual) may freely redistribute PLAY in its
  51. original unaltered (and PAKed) state provided that you do not
  52. charge money for the program. PLAY is intended for private use
  53. only.  It is copyrighted software.  It may not be used (in full
  54. or in part) for commercial applications, nor may it be used for
  55. demonstration purposes associated with commercial applications.
  56. If it is your desire to do so, I may be reached at the above
  57. address or at (805) 583-8173 to discuss licensing arrangements
  58. for including PLAY or its object code routines into your
  59. application.
  60.  
  61.  
  62. What You've Got Here
  63. ====================
  64.  
  65. This file "Play.pak" was created by another utility I put
  66. together called Pak (which is now floating around the various
  67. BBS's.)  In addition to the PLAY files, I've thrown in my LED
  68. program which swaps in/out the audio filter on an Amiga 500 or
  69. 2000.
  70.  
  71. Play           The Sonix score player itself
  72. Play.doc       The file you are now reading
  73. Play.info      An icon for the score player
  74. Score.info     A generic score icon
  75. Script.info    A generic script file icon
  76. Scores.info    A generic scores drawer icon
  77. LED            Swaps audio filter on A500/A2000
  78. LED.info       Icon for the LED program
  79.  
  80.  
  81. Playing Scores from the Workbench
  82. =================================
  83.  
  84. Before you can use PLAY from the Workbench, there's a little
  85. setting up to do.  First off, PLAY and it's ".info" file should
  86. be copied to the root directory of the disk that contains your
  87. Sonix scores.  Secondly, if your scores are located in a
  88. directory other than the root, you need to copy the "Scores.info"
  89. drawer icon into the score directory's parent directory. If your
  90. score directory is named "My Tunes" then the drawer icon should
  91. be named "My Tunes.info".
  92.  
  93. Thirdly, you need to make copies of the "Score.info" icon file
  94. for each score and place them in the same directory as that
  95. score.  These icons must have the same name as the score file
  96. with ".info" appended at the end.  If a score is named "Jingle
  97. Bells.smus" then the corresponding icon should be named "Jingle
  98. Bells.smus.info".  If the instruments for a particular score are
  99. in a different directory, then you must specify where they are in
  100. the icon file.  To do this, select the icon for the score, then
  101. select the Info item in the Workbench menu.  In the Tool Types
  102. box type the pathname of the instrument directory after the "I="
  103. and Save the info file.  Relative pathnames such as
  104. "I=/Instruments" are ok here.
  105.  
  106. Now, just double click on a score icon and it should load and
  107. play.  You may also use extended selection to play multiple
  108. scores in the order they were selected.  If PLAY encounters a
  109. problem and can't load the score it will "beep" the display and
  110. try to load the next score (if any.)  If you wish to stop playing
  111. a score, double click on the PLAY icon.  Also, if you try to play
  112. a score while another is playing, the new score will override the
  113. previous one.
  114.  
  115.  
  116. Playing Scores from the CLI
  117. ===========================
  118.  
  119. Usage: PLAY [*] [I=instrdir] score[.SMUS]
  120.  
  121. If you plan on using PLAY from the CLI then copy "Play" to your
  122. commands "c:" directory.  Just specify the pathname for the
  123. instruments directory and the pathname for the score, and PLAY
  124. will load and play that score. You don't need to type the ".smus"
  125. part of the score name as PLAY will do that for you if necessary.
  126. Use quotes if a pathname has spaces in it. If you want PLAY to
  127. run asynchronously, add the asterisk as the first parameter.
  128. This works better than "run" because it allows you to perform an
  129. "endcli" properly.  This is useful for playing songs from a
  130. startup sequence.  To stop a score while playing, just issue a
  131. Ctrl-C to abort (if PLAY is running asynchronously then use "play
  132. *" or start another score playing to abort the original score.)
  133.  
  134. Example:
  135.  
  136. 1> dir
  137.      Scores (dir)
  138.      Instruments (dir)
  139. 1> dir scores
  140.   Jingle Bells.smus           Cameo.smus
  141.   YTV.smus
  142. 1> play i=instruments "scores/jingle bells"
  143. 1> cd scores
  144. 1> play i=/instruments ytv cameo.smus
  145. 1> cd /instruments
  146. 1> play * /scores/cameo
  147. 1>
  148.  
  149.  
  150. Creating & Using PLAY Scripts
  151. =============================
  152.  
  153. PLAY scripts basicly allow you to sequence through many songs
  154. back-to-back. This feature is especially useful for slide shows
  155. or demonstrations that require backround music.  You might even
  156. want to setup a sequence of songs you want your Amiga to play in
  157. the backround while you are busy with other tasks.  One important
  158. feature of PLAY scripts is that they enable you to play one score
  159. while loading the next.  This way you get continuous music since
  160. no time is spent loading a score between songs.
  161.  
  162. To create a PLAY script, you need a text editor of some type.
  163. PLAY scripts consist of a series of options seperated by spaces,
  164. commas, or carriage returns.  Most options consist of a letter,
  165. an equals sign "=", and an argument.  If an argument (such as a
  166. pathname) has spaces in it then enclose that argument in quotes.
  167. When you save your PLAY script, you might want to use the
  168. extension ".play" so that you can distinguish PLAY scripts from
  169. other types of files.  PLAY script options are discussed in the
  170. next section.
  171.  
  172. You may start a PLAY script from either the Workbench or the CLI.
  173. You must put a copy of the "Script.info" icon file in the same
  174. directory with your PLAY script (appropriately renamed.)  Just
  175. double-click on the icon to start your script playing.  To invoke
  176. a PLAY script from the CLI you use the following:
  177.  
  178. Usage: PLAY [*] P=script
  179.  
  180. In addition to aborting a PLAY script with a Ctrl-C, you may stop
  181. the current song and skip to the next with a Ctrl-E.  When
  182. invoked from a CLI, PLAY can report any errors it encounters
  183. within a script file.
  184.  
  185. Example:
  186.  
  187. 1> dir
  188.      Scores (dir)
  189.      Instruments (dir)
  190.   Demo.play
  191. 1> dir scores
  192.   Cool.smus                   Cameo.smus
  193.   Rollover.smus               YTV.smus
  194. 1> type demo.play
  195. ;This is a demo PLAY script:
  196.  
  197. d=scores        ;Set current directory
  198. i=/instruments  ;Specify instruments directory
  199.  
  200. r=2                 ;Repeat the following twice
  201.   v=128 c=3 a=cool  ;1/2 volume & repeated 3 times
  202.   v=-1 a=cameo      ;Use score's original volume
  203. .                   ;End of repeat loop
  204.  
  205. r=0           ;Repeat the following forever
  206.   a=rollover  ;A bunch of asyncronous scores
  207.   a=ytv
  208.   c=2 a=cool  ;Repeated twice again
  209.   a=cameo
  210. .             ;End of repeat loop
  211. 1> play p=demo.play
  212. 1>
  213.  
  214.  
  215. PLAY Script Options
  216. ===================
  217.  
  218. These options may be used in either a PLAY script or in the
  219. command line itself.  For simplicity's sake, the usage desciptors
  220. do not indicate all of these options.
  221.  
  222. score       A filename by itself indicates a score to be loaded
  223.             and played. PLAY will append ".smus" to the filename
  224.             as necessary.
  225.  
  226. A=score     This option tells PLAY to play the specified score
  227.             and proceed immediately with loading the next score.
  228.             This allows for continuously playing music.
  229.             One drawback is that you need enough memory to hold
  230.             two scores and their instruments into memory at
  231.             one time.
  232.  
  233. I=instrdir  This specifies to PLAY where to look for a
  234.             score's instruments. This applies to all subsequent
  235.             scores until it is changed again with another "I=".
  236.             Relative pathnames are ok here.
  237.  
  238. D=newdir    PLAY scripts inherit their current directory
  239.             from the Workbench or CLI.  You can specify a new
  240.             current directory with this option.  Relative
  241.             pathnames are also legal here.
  242.  
  243. C=count     Specifies how many times to repeat a score.
  244.             A value of zero indicates that this score is to be
  245.             repeated forever (or until aborted...)  The count
  246.             value applies only to the next score to be played.
  247.  
  248. V=volume    Specifies the volume at which the following scores
  249.             will be played.  The valid range is from 0 to 255.  A
  250.             value of -1 uses the score's default volume.
  251.  
  252. R=repeat    This option allows you to repeat a block of options
  253.             (and scores) a number of times.  The repeat block is
  254.             bounded by the repeat option and a period "." (or
  255.             another repeat option.) A value of zero indicates
  256.             that the block is to be repeated forever. Repeat
  257.             blocks only work from within PLAY scripts.
  258.  
  259. ;comment    A semi-colon ";" indicates that the rest of a
  260.             line is a comment.
  261.  
  262. P=script    You may link to another PLAY script from
  263.             within a PLAY script.
  264.  
  265.  
  266. The LED Program
  267. ===============
  268.  
  269. This program toggles the brightness of the front panel LED.
  270. Also, on the Amiga 500 & 2000 it will swap in/out the audio
  271. filter.  It can be started from either the Workbench or the CLI.
  272. Type "LED ?" to see the parameters for CLI invocation.  While
  273. running a program that uses Amiga sound output, try double
  274. clicking on the icon and you'll notice a substantial difference
  275. when the filter gets swapped out.  It's like someone took the
  276. cotton out of your ears!  You may hear a squealling sound; this
  277. is the aliasing that the filter was designed to eliminate in the
  278. first place.  Double clicking again will turn the filter back on.
  279.  
  280. Example:  (for using with the CLI)
  281.  
  282. 1> play * ytv   ;Play a score asynchronously
  283. 1> led ?        ;Lets you see usage
  284. LED 1.1 - Mark Riley - 11/11/87
  285. Usage: LED [DIM|BRIGHT|TOGGLE]
  286. 1> led          ;Toggles status of audio filter
  287. 1> led bright   ;Turns filter on
  288. 1> led dim      ;Turns filter off
  289. 1> led toggle   ;Same as "led" by itself
  290. 1>
  291.